Succubus Heart
- Created By : Michael P Stanich (AKA Spirit Shard)
- michaelpstanich.com

This is an external version of the Help MCM available in-game with some minor additions that couldn't fit in the MCM itself.

Don't forget to join our Discord! - https://discord.gg/h3vB7S4FEw
In the Discord you can get updates, assistance, or just hang out!

> Un-implemented <
(This is for proof-reading and concepting before messing with the menu)

Key Terms / Descriptions

Status :
	General term for Health, Magicka, and Stamina
Max Status :
	Current Max Health, Magicka, or Stamina your character can heal too, independant of Status Cap and Drain. (Ex. With a Max Status of 150 Health, you can heal up-to 150 Health.)
Status Cap :
	Highest Health, Magicka, or Stamina your character can Drain too, your Max Status can't stay above this value. (Ex. If your Max Status is 120 but your Status Cap is 150, you can drain an additional 30 status, bringing your Max Status up-to 150)
HeartXP :
	Succubus Heart Experience gained through Succubus Heart activities such as sex, consuming sperm/milk, or through passives. HeartXP is used to enhance your Native Succubus Stats through the Heart Levels MCM or upgrade various features. (This is your main progression XP)
SkillXP :
	Skill Experience earned through Succubus Heart activities, such as draining beyond your Status Cap or utilizing Passives/Actives. SkillXP can be spend in the Skill Levels MCM to level up vanilla skills.
Sex Bonus (Time) :
	Temporary buffs timer that increases during sex and decreases when not having sex. Certain Passive/Active abilities will use this to determine their effect.
Fluid Bonus (Time) :
	Temporary buffs timer that deccays over time. Increase the available time by consuming Sperm/Milk (Sexual Fluids). Certain Passive/Active abilities will use this to determine their effect.


Sex Act :
	Refers to Any Sex Animation as opposed to defining a specific type of sex act or animation. Only includes those managed by SexLab.

Menu Descriptions

Status :
	View key stats related to your Status, Succubus Abilities, and the mod's current state. Can also set overrides and lock various stats.
Heart Levels :
	Use HeartXP to enhance your native Succubus Stats. Earn HeartXP through Succubus Heart activities such as draining enemies or satisfying your desires.
Skill Levels :
	Spend Skill Points you've earned through Succubus Heart to level up vanilla skills. Earn Skill Point XP through Succubus Heart activities, such as draining beyond your Status Cap, and, when enough is accumulated, Skill Points will be generated.
Passives :
	Spend/Decrease Status Caps to unlock or strengthen your Passive Succubus Abilities. Passive Abilities gain additional bonuses based on your BDSM Rating. BDSM Rating is improved when increasing Heart Levels.
Actives :
	Spend/Decrease Status Caps to unlock or strengthen your Active Succubus Abilities. Active Abilities gain additional bonuses based on your BDSM Rating. BDSM Rating is improved when increasing Heart Levels.
Soul Pets :
	MCM for managing your Soul Pets. When souls have been replicated they'll show up here, select their slot for various options. Soul Pets will level up and strengthen through gameplay.
Titles :
	Earn Reputaion through various activities for bonus HeartXP.
Help :
	This MCM menu stores general information and help articles. If you're having issues understanding mechanics or want to check what various terms refer to, check here! If you don't find help here you can still join the Discord channel for further assistance!

The Basics

Drain and it's Effects :
	With the powers of a succubus, the player will be able to Drain Max Status from their partners! This will decrease the partner's Max Health/Magicka/Stamina and instead give it to the player character. Drain in the same sex acts will have a decaying efficiency, each time reducing the effect by 20%. This decay effect resets every Sex Act, so go find more partners!
Arousal and Withdrawl :
	Over time your Succubus will slowly become aroused over time or through specific actions. As arousal increases your Succubus will experience withdrawl with debuffs and negative side effects, however, finally satisfying their desires will offer larger bonuses at higher arousal. Arousal works in tiers, below 50% your Succubus Drain powers are reduced, at 100% your Succubus opporates at full capacity, at 150% your Succubus starts to experience Withdrawl with negative side effects, beyond 200% can become dangerous...
Earning and Spending HeartXP :
	Your main progression experience, HeartXP, is earned in Sex Acts based on how long the animation lasts with bonuses that can be applied to earn even more HeartXP. HeartXP is used to level Native Succubus Abiltiies in the Heart Levels menu, making your succubus stronger!
Earning and Spending SkillXP :
	SkillXP is earned through special conditions, such as draining Status when you're already at your current Status Cap or through passives. SkillXP can be spent to level up vanilla skills in the Skill Levels menu.
Sex/Death Drops :
	Special drops can be obtained when a character orgasms or dies (I know, both sides of the isle). On orgasm their partner may recieve sexual fluids based on their gender with a small chance for rare varients. Death drops are 'soul' items added to a character's inventory when they die. Both can be used to enhance stats or gain additional HeartXP, SkillXP, ect.
BDSM Rating and Abilities :
	When improving your Heart Levels your succubus will improve their BDSM Rating. the BodyDesireSoulMind Rating is used by passives/actives to determine and strengthen their effect (in other words, BDSM rating is how powerful passive/active abilities can be). These Passive abilities are always active and offer various effects, while Actives require a spell to use but can be quite powerful when leveled. Unlocking both Passives and Actives cost Status Cap.
Unlocking Titles :
	Titles are a fun way to track how you play and unlock some bonus HeartXP. As different actions are performed they will tally up into a certain type of reputation stat. When certain milestones are met you'll unlock new titles and be granted bonus HeartXP upon upgrading them in the MCM. (Note : Titles are designed to be a fun additional mechanic and promote experimentation with differnt mechanics, but are in no way required and generaly only offer HeartXP as a reward)

Optional Mechanics

The Succubus Realm :
	The Succubus Realm is a small location that can be access and departed by using the 'Succubus Realm -Connect-' Spell. This location offers several useful crafting stations, NPCs that offer items for sale, and more. Upon leaving with the spell you can return either directly back where you entered from or to another location presented in the menu. The Succubus Realm can act as almost a home-base of sorts, or be completely ignored.
Offering System :
	In the Succubus Realm resides an Offering Chest. Placing certain items inside, like Blood Chips, will present an offering to the Succubus Goddesses. If the Goddesses excepts the offered amount the player Succubus will be rewarded with items. Some Succubus Items can also be merged using this system, placing large numbers of Succubus items may return an upgraded version. [Note : With DOM enabled, Offering rewards can include items lost when defeated, acting as an alternative to re-buying items back from tali.]
Fluid Fountain :
	In the Succubus Realm there is a fountain which offers up daily sexual fluids (runs based on in-game time, so waiting 24 hours spawns more fluids to collct). This fountain can be upgraded to give more fluids using Blood Chips.
Tali's Worktable :
	In the Succubus Realm Tali has a worktable with a chest set next to it. When placing items in Tali's Worktable Chest, she will begin replicating items left in the chest and adding them to her shop and to the Offering System's reward pool. You can help Tali by leaving Blood Chips at her Worktable, allowing her to replicate things faster. (Note : Tali's worktable updates every in-game hour, removing items from the chest will apply changes on the next hourly update)
Soul Pets :
	Soul Pets allows you to replicate nearly any NPC and use them as a companion. You can summon or desummon them on command, use them for combat or for pleasure, and as they're used they level up, unlocking special traits changing their stats and behavior. [Soul Pets is its own mod integrated into Succubus Heart]
Combat Seduction :
	Combat Seduction is a simple and light-weight Combat Submit mod (if you're already using a Combat Submission mod you'll want to leave this disabled). Combat Seductions makes characters submit to their attackers when their Status is low enough, triggering sex scenes. [Combat Seduction is functionally its own mod integrated into Succubus Heart]
Death Override Mode :
	Death Override Mode is a Death Alternative mod inspired by Rogue-lites. Instead of dying the player is revived in the Succubus Realm with the chosen side effects, by default equipment is removed and can re-purchased from Tali, an NPC in the Succubus Realm. By default the mod is designed to keep gold and levels as your primary progression with items and equipment being disposable, however the mod can be re-configured to work as the player chooses. [Death Override Mode is its own mod integrated into Succubus Heart]
Random Notes

Woops... :
	I was exploring the Succubus Realm when I came accross a suspicious chest! I felt I should put something inside, but I shouldn't have put my favorite hat in there...
He's always there for me <3 :
	He's just so useful and always there for me when I need him most! I forgot my backup potions at home so I called him over and after a bit of huff and puff, bam! He had me slurping down some healing, right when I needed it! Am I... am I falling in love..?


Keywords [ For Modders or Tinker-ers]

Add these keywords to items to have them affect Succubus Heart

SuH_key_milk = Apply to "Breast Milk" Items for integration with Succubus Heart
SuH_key_sperm = Apply to "Sperm" Items for integration with Succubus Heart
SuH_key_incxp = Will make a consumable give HeartXP